.
It is important to note that the configuration file is not read only on startup, but each time it is changed. Several
properties, including those for Moab Workload Manager (
) are processed after each change and can affect the runtime behavior of MWS.
For all possible values that can be set, please see the Grails reference guide. For project specific settings
(usually the only ones you'll need to change), you may set the following properties:
| Property | Type | Default | Description |
|---|
| grails.mongo.host | String | 127.0.0.1 | The MongoDB host to use (Note that MongoDB runs on 127.0.0.1 and not localhost by default) |
| grails.mongo.port | Integer | 27017 | The MongoDB port to use |
| grails.mongo.replicaSet | List of Strings | n/a | The MongoDB replica set servers to use (e.g. ["moab1:27017","moab2:27017"]); note that grails.mongo.host must be set to null to use this option |
| grails.mongo.databaseName | String | mws | The MongoDB database name to use |
| grails.mongo.username | String | - | (Optional) The username to use when connecting to MongoDB |
| grails.mongo.password | String | - | (Optional) The password to use when connecting to MongoDB |
| grails.mongo.options.connectionsPerHost | Integer | 50 | The number of connections allowed per host |
| grails.mongo.options.threadsAllowedToBlockForConnectionMultiplier | Integer | 5 | The number of threads per connection allowed to wait for an available connection |
| grails.mongo.options.autoConnectRetry | Boolean | true | Controls whether the system retries automatically on connection errors |
| grails.mime.use.accept.header | Boolean | false | When enabled, uses the HTTP Content-Accept header to determine the content type used for return data (JSON only for now) |
| auth.defaultUser.username | String | admin | Username of the default admin user (only created if no other users exist) |
| auth.defaultUser.password | String | adminpw | Unencoded password of the default admin user, must be different from username |
| grails.plugins.springsecurity.basic.realmName | String | Moab Web Services | The HTTP realm used when using basic auth |
| grails.plugins.springsecurity.active | Boolean | true | Enables or disables security for MWS as a whole, including all providers |
| grails.plugins.springsecurity.useBasicAuth | Boolean | true | Enables or disables basic auth with a simple username/password |
| grails.plugins.springsecurity.oauthProvider.active | Boolean | true | Enables or disables the OAuth2 provider |
| ldap.baseDNs | List of Strings | - | A list of distinguished names that are the root entries for LDAP searches |
| ldap.bindUser | String | - | The distinguished name of the LDAP bind user |
| ldap.directory.type | String | - | The type of LDAP directory (e.g. "Microsoft Active Directory"). See Configuration for valid values. |
| ldap.password | String | - | The password of the LDAP bind user |
| ldap.port | Integer | - | LDAP server's port |
| ldap.security.server.certificate | String | - | The filename of the LDAP server's PEM encoded X.509 certificate. See Security for more information. |
| ldap.security.type | String | - | How the connection between MWS and LDAP is secured. See Security for more information. |
| ldap.server | String | - | LDAP server hostname or IP address |
| moab.server | String | localhost | Moab server hostname or IP address |
| moab.port | Integer | 42559 | Moab server's port |
| moab.secretKey | String | moabsecret | Secret key used to communicate with Moab, see Moab Configuration |
| moab.databaseName | String | moab | The name of the MongoDB database to use to retrieve current MWM data; this should match the database setting in MWM |
| mam.server | String | localhost | Moab Accounting Manager server hostname or IP address |
| mam.port | Integer | 7112 | Moab Accounting Manager server's port |
| mam.secretKey | String | mamsecret | Secret key used to communicate with Moab Accounting Manager |
| mws.suite | String | CLOUD | The suite or context that MWS is running in (see Suite for valid values) |
| mws.hooks.location | String | hooks | The directory (relative or absolute) where Hooks are stored. See the hooks section for more information. |
| mws.plugins.location | String | plugins | The directory (relative or absolute) where Plugins are stored. See the plugins section for more information. |
| mws.certificates.location | String | etc/ssl.crt | The directory (relative or absolute) where plugin certificates are stored. See the Managing SSL Connections section for more information. |
| mws.docs.maxResults | Integer | 100 | Maximum number of results to return for a single search in the documentation |
| mws.cache.duration.default | Integer | 60 | The default number of seconds to use for caching objects from Moab. This is only supported in certain objects such as policies. |
| mws.cache.duration.policy | Integer | 180 | The number of seconds that the cache for policies is valid. If set to null, the default is used. |
| plugins.pluginType | String | - | Default configuration value for the plugin pluginType field (see Setting Default Plugin Configuration). |
| plugins.autoStart | Boolean | true | Default configuration value for the plugin autoStart field (see Setting Default Plugin Configuration). |
| plugins.pollInterval | Integer | 30 | Default configuration value for the plugin pollInterval field (see Setting Default Plugin Configuration). |
| plugins.config | Map | - | Default configuration value for the plugin config field (see Setting Default Plugin Configuration). |
| plugins.loadInitialPlugins | Boolean | true | If true, loads the initial plugins defined for uploaded or built-in plugin types (see Plugin Projects and Metadata). |
| plugins.stateConsolidationPolicy | NodeStatePolicy | null | If "optimistic", treats state data optimistically. If "pessimistic", treats state state pessimistically. May be null. See Plugin Data Consolidation for more information. |
| plugins.defaultHypervisorType | String | ESX | This is reported to MWM when a node report references a hypervisor image that does not have the hypervisorType or extensions.xcat.hvType fields set. See ImageHypervisorType. |
| Logger | Default | Description |
|---|
| grails.app | debug | Most classes in the main MWS application |
| grails.app.bootstrap.BootStrap | debug | Handles startup and initialization of MWS |
| com.ace.mws | debug | The base logger for MWS specific functionality not included in other loggers (this comprises very few classes) |
| grails.app.services.com.ace.mws.plugins.PluginUtilityService | debug | Class for initializing and helper methods of plugins |
| com.ace.mws.hooks.HookUtils | debug | Helper class for loading hooks during startup process |
| plugins | debug | All MWS plugins |
| com.ace.mws.plugins | debug | MWS plugin helper class, used to create and initialize plugins |
| com.ace.mws.gapi | warn | Base logger for all Moab connections, requests, and responses |
| com.ace.mws.gapi.Connection | info | Logger which controls all requests and responses from Moab |
| com.ace.mws.gapi.parsers | info | Loggers for parsers of Moab's data |
| com.ace.mws.gapi.serializers | info | Loggers for all serialization from MWS to Moab Wire Protocol |
| grails.app.service.grails.plugins.reloadconfig | info | Handles dynamic reloading of configuration files |
| net.sf.json | error | JSON and XML processing library |
| org.springframework.security | info | Authentication/authorization logger |
| org.codehaus.groovy.grails.web.servlet | error | Loggers for request handlers |
| org.codehaus.groovy.grails.web.mapping | error | URL mapping |
| org.codehaus.groovy.grails.web.mapping.filter | error | URL mapping |
| org.codehaus.groovy.grails.plugins | error | All grails plugins (MWS internal) |
| org.codehaus.groovy.grails.commons | error | Core application and classloading |
